AI SDK Kotlin/ai.torad.aisdk/ContentPart/ToolApprovalRequest

ToolApprovalRequest

@Serializable

@SerialName(value = "tool-approval-request")

data class ToolApprovalRequest(val toolCallId: String, val toolName: String, val input: JsonElement, val approvalId: String? = null, val signature: String? = null, val providerMetadata: Map<String, JsonElement>? = null) : ContentPart

Assistant content: the LLM called a tool that requires approval.

Constructors

ToolApprovalRequest

constructor(toolCallId: String, toolName: String, input: JsonElement, approvalId: String? = null, signature: String? = null, providerMetadata: Map<String, JsonElement>? = null)

Properties

approvalId

val approvalId: String?

Approval-identity key distinct from toolCallId per v6 (gap #7 in historical parity work). Null defaults to toolCallId for the common single-approval case; explicit value lets two approvals share a tool-call id without correlation ambiguity.

input

val input: JsonElement

metadata

val ContentPart.metadata: Map<String, JsonElement>?

providerMetadata

val providerMetadata: Map<String, JsonElement>?

signature

val signature: String?

HMAC-SHA256 signature binding this approval to its tool call (v6.0.202). Present only when the agent is configured with experimental_toolApprovalSecret; verified fail-closed when the approval is replayed.

toolCallId

val toolCallId: String

toolName

val toolName: String

Functions

providerMetadataAs

inline fun <T> ContentPart.providerMetadataAs(provider: String): T?

fun <T> ContentPart.providerMetadataAs(provider: String, serializer: KSerializer<T>): T?